Skip to content

briefs: expand to 7 roles + add failure-analyst - #7

Merged
KI7MT merged 1 commit into
mainfrom
briefs/seven-role-bundle
May 10, 2026
Merged

briefs: expand to 7 roles + add failure-analyst#7
KI7MT merged 1 commit into
mainfrom
briefs/seven-role-bundle

Conversation

@KI7MT

@KI7MT KI7MT commented May 10, 2026

Copy link
Copy Markdown
Owner

Summary

Patton's request (KI7MT-approved via inbox UI). Expands the six existing example briefs from sketches (~20 lines each) to full role definitions (~80–120 lines each), and adds a seventh role — failure-analyst — that closes a real gap in the example set.

Type of change

  • Documentation
  • Bug fix / new feature / refactor / tests / build

What changed

Brief Lines (before → after)
architect.md 20 → 91
implementer.md 20 → 87
reviewer.md 22 → 88
tester.md 20 → 96
ops.md 19 → 96
operator.md 18 → 97
failure-analyst.md new → 115
examples/README.md rewritten with pipeline diagram + skeleton docs
README.md one-paragraph pointer at the brief-format section

Every brief uses the same seven-section skeleton: role + disposition, strengths, avoids, inputs, outputs, hand-offs, when to use.

Why a failure-analyst slot

Distinct from reviewer (reviewer reads diffs and reports; failure-analyst writes throwaway probes to falsify claims, then reports what survived) and from tester (tester writes coverage; failure-analyst writes attacks). The combination — does not write production code, writes adversarial tests, owns the failure-mode taxonomy — wasn't captured in any of the existing six.

Pending: Watson voice review

Patton's explicit ask was to run the bundle past Watson for consistency-of-voice review before committing. CI runs on this PR; merge held until Watson signs off via inbox.

Checklist

  • All tests passing locally (159 Python + 7 Go)
  • ruff clean, golangci-lint clean
  • No code changes (briefs + READMEs only)
  • No secrets / debug logging

Patton's request, KI7MT-approved. Six existing briefs (~20 lines each)
expanded to ~80-120 lines using a consistent seven-section skeleton.
New seventh role failure-analyst added.

Skeleton (every brief)
  1. One-paragraph role + disposition
  2. Strengths     concrete capabilities, not adjectives
  3. Avoids        what the agent declines, even if asked
  4. Inputs        what to send, in what format
  5. Outputs       what to expect back, in what shape
  6. Hand-offs     who receives output and what they need
  7. When to use   right time vs wrong time

Brief line counts (before -> after)
  architect.md         20 -> 91
  implementer.md       20 -> 87
  operator.md          18 -> 97
  ops.md               19 -> 96
  reviewer.md          22 -> 88
  tester.md            20 -> 96
  failure-analyst.md    0 -> 115  (new)
  total               119 -> 670

Why a failure-analyst slot

Distinct from reviewer (reviewer reads diffs and reports; failure-
analyst writes throwaway probes to falsify claims, then reports what
survived) and from tester (tester writes coverage; failure-analyst
writes attacks). The combination - does not write production code,
writes adversarial tests, owns the failure-mode taxonomy - was not
captured in any of the six existing briefs.

examples/README.md
  Rewritten to introduce the seven roles, include an ASCII pipeline
  diagram, document the seven-section skeleton, and walk through
  copying the bundle into the runtime briefs directory.

README.md (root)
  One-paragraph pointer at the brief-format section directing readers
  to examples/briefs/ and examples/README.md. Closes the
  discoverability gap Patton flagged.

Pending: Watson voice review before merge (Patton's explicit ask).
Tests + lint still clean (159 Python + 7 Go, ruff + golangci-lint
both 0 issues). No code changes - content only.
@KI7MT
KI7MT merged commit 98837d4 into main May 10, 2026
12 checks passed
@KI7MT
KI7MT deleted the briefs/seven-role-bundle branch May 10, 2026 00:56
KI7MT added a commit that referenced this pull request May 10, 2026
Patton's expansion pass + failure-analyst slot (PR #7, merged) is the
first user-facing content beat since the v0.3 series started. Minor
bump fits — meaningful new surface for operators copying the bundle,
not just internal CI/test infra.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant